*6 JUN 1972	PUB MANUAL	TES

A new version of PUB was put up today with some obscure bugs fixed.
Indexes and headings now work well.  AFTER PAGE does not always
work, but AFTER TEXT is usually equivalent and does work.
If you must use old version, please tell me why! To use it, log in
as 12,TES and RUN PUB.

There is a new manual: SPOOL PUB.TES[S,DOC]/N/B   It is 80 PAGES long, so
if you don't plan to use PUB for a few months, it is advisable to
wait for the SAILON to be printed.  The new manual has an index
and a tutorial for beginners, plus appendices with (untested) examples.
To use PUB for simple purposes, only a portion of the manual needs to be
read.

*12 DEC 72	PUB	TES
PUBMAC.DFS[1,3] has been edited to correct an error in INDEX creation.
The old version is PUBMAC.OLD[1,3] for a few weeks.

The PUB manual has been deleted from the disk.  The abstract remains
on PUB.TES[S,DOC].  Bound copies are in the SAILON file drawer.

In January, a new-SAIL PUB should be up with several obscure but
annoying bugs removed.  Major restrictions and bugs now known:
	SEND INDEX ⊂ ... ⊃	must be all on one line
	See {PAGE X}		must be followed by a non-word-break
					such as  ) , ; ] .
					but definitely not a SPACE
	NARROW, WIDEN, VARIABLE only work within a block -- not at top-level.
	TURN OFF "}" inside blocks doesn't always work right (just for "}")
	↓_abc_abc_abc_↓ seems not to work right in FILL mode someplaces.
	Footnotes hack a lot, esp. if the page fills up during one.

*5 MARCH 1973	PUB	TES

THIS NOTICE IS ABOUT 70 LINES LONG, IN DECREASING ORDER OF
    IMPORTANCE.

A NEW VERSION OF PUB IS UP TODAY WITH MANY REPAIRS AND A
FEW CHANGES.  OLD VERSION IS PUB.OLD.  SEE TES WITH PROBLEMS.

NOTE:  UNTIL THE NEXT VERSION OF PUB IS UP, XGP USERS SHOULD
USE THE "DEVICE TTY" COMMAND OR THE "/T" SWITCH, ESPECIALLY
IF THE PAGE FRAME IS HIGHER THAN 53 LINES.

ABOUT 15 KNOWN BUGS HAVE BEEN FIXED (THANKS TO RKJ AT CMU FOR
A COUPLE OF STICKLERS).  FOOTNOTES SHOULD WORK BETTER;
VARIABLE DECLARATIONS WORK; CROSS-REFERENCES OF THE FORM
"UNIT!" LABEL  NOW WORK; AREA TEXT AND COUNT PAGE CAN ONCE
AGAIN BE DECLARED IN BLOCKS; ROMAN NUMERALS, MOD, MIN, AND,
GROUP BEGIN...END, INSERT...PORTION (WITH NO SENDS), AND SOME
OTHER THINGS NOW WORK WELL.  TRY OUT YOUR FAVORITE BUG.

ONE BUG NOT YET FIXED: SOMETIMES PUB WILL LOOP
WHEN THERE ARE AREAS DECLARED THAT DON'T START AT CHAR 1.
REPORT OTHER BUGS TO TES.

CHANGES AND NEW FEATURES:
(1) TYPEOUT DURING COMPILATION RESEMBLES NEW SAIL'S.
    NOTE: FILES LIKE 3INDE.PUZ AND 2CONT.PUG ARE GENERATED
    FILES.  PAGE 1 OF TV FILES IS NOT REPORTED BY PUB.

(2) THERE IS NO LONGER A BLANK PAGE AT THE BEGINNING OF LPT
    DOCUMENTS.

(3) NEW COMMAND TO CIRCUMVENT CHANGE (2): "BLANK PAGE N" CLOSES
    THE CURRENT PGE AND LEAVES N BLANK PAGES IN THE DOCUMENT.
    THE PAGE COUNTER IS NOT AFFECTED.  IF N IS OMITTED, 1 IS
    ASSUMED.

(4) FOR TTY USERS: INSTEAD OF CURLY BRACKETS AND HORSESHOE
    BRACKETS, YOU CAN NOW USE THE FOLLOWING CHARACTER PAIRS:
        $( MEANS LEFT HORSESHOE (OPEN MACRO)
        )$ MEAN RIGHT HORSESHOE (CLOSE MACRO)
        ]$ MEANS RIGHT BRACE (SWITCH TO TEXT MODE)
    THESE ARE ONLY VALID IN COMMAND MODE AND NEED NOT BE TURNED
    ON.  ON THE OTHER HAND, THE FOLLOWING CONTROL CHARACTERS
    ARE ONLY RECOGNIZED IN TEXT MODE AND MUST BE TURNED ON
    (OTHER CHARACTERS MAY BE TURNED ON FOR THEM):
        $[ MEANS LEFT BRACE (SWITCH TO COMMAND MODE).

(5) NEW FEATURE: TURN ON/OFF TAB FOR "<CHARACTER>" ;;
    AS PUB READS THE MANUSCRIPT, IT SUBSTITUTES FOR EACH "TAB"
    FROM ONE TO EIGHT SPACES.  THIS COMMAND CHANGES PUB SO THAT
    IT SUBSTITUTES THE SINGLE CHARACTER <CHARACTER> INSTEAD.
    THE COMMAND MUST BE FOLLOWED BY TWO SEMICOLONS OR ELSE IT MAY
    NOT TAKE EFFECT ON THE NEXT LINE.  IF IT IS DECLARED IN A BLOCK,
    THE "END" OF THE BLOCK MUST BE FOLLOWED BY TWO SEMICOLONS OR
    THE ORIGINAL MEANING OF TAB MAY NOT REAPPEAR IN TIME FOR THE
    NEXT LINE.

(6) SINGLE SPACE, DOUBLE SPACE, AND TRIPLE SPACE NOW BREAK BEFORE
    CHANGING THE VALUE OF SPREAD, SO THEY TAKE EFFECT IMMEDIATELY.

SUGGESTIONS AND WARNINGS:
(1) "COUNT PAGE" INITIALLIZES THE PAGE COUNTER TO NULL.  IT
    GETS STEPPED TO 1 THE NEXT TIME A PAGE IS OPENED.
    THIS IS WHY THE TITLE PAGE HAS A BLANK PAGE NUMBER.

(2) AREA RE-DECLARATIONS DO NOT TAKE EFFECT UNTIL THE
    CURRENT PAGE IS CLOSED.

(3) IF YOUR DOCUMENT IS LONG, IT IS HELPFUL TO HAVE A SOURCE
    FILE FOR EACH CHAPTER, AND ON EACH DEBUG RUN TO "REQUIRE"
    FROM THE MAIN MANUSCRIPT FILE ONLY THOSE CHAPTER FILES THAT
    YOU ARE TESTING.  GLOBAL MACROS SHOULD APPEAR IN THE MAIN
    FILE OF COURSE.

THE MANUAL HAS NOT BEEN CHANGED, BUT IT IS BACK ON THE DISK
FOR THE BENEFIT OF NET USERS (SEE PUB.TES[S,DOC] FOR DETAILS).

*5 April 1973	PUB	TES
Users of Jerry Agin's underground figure macros note:

"MACRO SECREF" et al have a bug which was ignored by old
versions of PUB but now result in the error message:
	"EXTRANEOUS { IN COMMAND LINE"
To fix this, remove both the { and } from these particular
macros.  E.G.:
	.MACRO SECREF ⊂ "Section " ;{SECTION! LBL} ⊃
should be:
	.MACRO SECREF ⊂ "Section " ;SECTION! LBL ⊃

If you like, this can be abbreviated:
	.MACRO SECREF ⊂ "Section!" LBL ⊃
which did not work in old versions but now does!